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Chapter 1 

Introduction 


SquawkBox for psl is the pilot/plane side of a larger system. This larger 
system consists of a cluster of Unix server machines on the I nternet that 
coordinates the message traffic between all connected pilots/planes and air 
traffic controllers/ground stations. In this manual, we will call this system 
the network. 

There are several organisations providing the same service with essen¬ 
tially the same software. As long as the protocol is the same, sb747 can 
connect to all these networks, vatsim and ivao are the biggest networks 
at the moment. 

For quite a time, virtual atc was almost exclusively accessed by pilots 
flying Microsoft Flight Simulator, using the freeware SquawkBox program 
byj oej urecka. With the introduction of SquawkBox for psl, pilots now can 
get their hands on the controls of the only current true heavy jet simulator 
and join the sightseeing crowds in the skies all over the world. 


1.1 What You Can Expect 

sb747, like the original SquawkBox program, must be used on top of a 
flight simulator, in this case the Aerowinx 747-400 Precision Simulator. The 
sb747 program will let you connect to the server cluster, log in as a licensed 
pilot, and contact all activeATC stations from clearance delivery via ground 
control and tower to departure and center, all the way tothe arrival airport. 
You use a text-based interface (message lines) on the psl flight deck to 
communicate with the controllers, or a live voice system called RogerWilco. 
sb747 contains most bells and whistles of the original SquawkBox, such 
as private communications, metar and atis reception facilities, and many 
features that make the system nice to use. You even have the same weather 
in the simulator as there is on the same spot in the real world. 

People using msfs with SquawkBox will see you through their wind¬ 
shields. If they have set up their systems correctly, they will even see you 
as a Boeing 744, with the proper company livery. 

Combined with psl's outstanding simulation of a 744’s systems, sb747 
provides the finishing touch in simulated ifr flying. 
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1.2 What You Can Not Expect 

The most salient aspect of a crowded flight environment will not be present: 
you will not see other aircraft in stunning graphical detail. This is due to 
the limited graphical capabilities of the current major version of Precision 
Simulator and cannot easily be improved. I n practice, this is not a severe 
limitation, except when taxiing and waiting in line for takeoff clearance. 
All other phases of flight are strictly ifr. 

However, several programs are availableto extend the current psl soft- 
warewith a direct linktoMSFS sothat you can usethis graphical workhorse 
for its natural application - looking out of the window - while still 'flying' 
psl on another computer. 1 2 Using this system, you can see the other 
planes, and most of the weather, too! 

Likewise, the tcas aboard the psl 744 is not linked up to the virtual 
environment. However, linking up tcas is far less complex than providing 
the outside scenery. An external program already provides some of the 
required functionality, see Section 7.6. Other traffic using msfs will see 
you on their tcas, though, just as with outside scenery. SB 747 provides 
the scenery generators described in the previous paragraph with the data 
required for traffic display, but as of this writing, neither of them supports 
this feature yet. 

Markus Vitzetum's external instrument panels 1 2 3 include the traffic in¬ 
formation of sb747 and even calculate proper tcas warnings. 


1 http://www.jcavanagh.flyer.co.uk/si/alpha.htm 

2 http://mypage.bluewin.ch/Visual744/ 

3 http://www.displays.glideslope.de/ 
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Chapter 2 

Installation 


To install sb747, just create a suitable directory somewhere (we suggest 
calling it sb747) and unpack the . zip file in this directory with a suitable 
unzipper, such as WinZip, pkunzip, or unzip. The result will be three 
additional directories inside your directory, bin, etc, and lib. Make sure 
you use the 'create directories' option of your unzipper (-d with pkunzi p, 
Use Folder Names with WinZip)! 

You now have installed sb747. If you are in High Anxiety Mode with 
the Broker already installed and running, and just want to get going, you 
are cleared to proceed directly to Chapter 3. 

2.1 Files 

This section describes the purpose of the files that make up SB 747. 

I n thebin directory you will find a single, rather large(3Mb) executable 
called sb7 4 7 . exe, in lib one file called priority.dll, and in etc four 
files cal led aircraft. cfg, hosts.txt, icaopos . txt, and expand. txt. 
These small files are plain ascii lists of network servers, supported aircraft 
liveries, icao weather stations, and phrase shortcuts, respectively. 

You only need to change the hosts .txt file if there is a change in the 
server cluster. Newer releases of SB747 will include all required modifica¬ 
tions, but you can make them yourself as well. Some firewall setups also 
might require changes in this file. I n case you fly on more than one network, 
you can add your pilot id and network password after the server lines, us¬ 
ing colons (':') as separators just as the rest of the line. If you do this, 
selecting a new server will also select the correct pilot i d and password. 

The file aircraft. cfg is a plain copy from the csl plane model li¬ 
brary 1 for the 'original' SquawkBox byj oej urecka and others. It contains 
all plane models that correctly show up in the Microsoft flight simulator. 
When a new csl library is released, you can replace this file by the new 
one. SB747will correctly pick up the available 744 model liveries from this 
file. 

The icaopos.txt file contains over 6000 icao stations and their po¬ 
sitions in latitude and longitude, plus elevation data. sb747 uses this list 

1 http: //avsim. com/mike/sb_pc/csl/ 
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to look for the nearest weather station while you are in flight and for some 
altitude corrections to winds, clouds, and temperatures. You may edit this 
file as needed. 

The expand. txt file is described in moredetail in Section 7.5. 

When you run the sb747.exe file, it will create etc/sb747.ini, in 
which your personal preferences will be stored. For debugging purposes, 
etc/debug, log will also be created. This file may be thrown away at any 
time, but in case of problems, it might contain valuable tracing information 
that the sb 747 authors might find useful. 

Thereare no other files involved in the SquawkBox system. If you delete 
all files and the directories, every trace of the program is gone from your 
machine. If you want to move the program, just move all files together, as 
long as you maintain the structure with the three subdirectories. 

The reason why you get a small directory tree instead of just a flat struc¬ 
ture has to do with the development of sb747. Full source code releases, 
when available, will be able to gracefully coexist with the current wrapped 
versi on i n the same di rectory tree. 

2.2 The 747 Broker 

sb747 just by itself cannot work with psl. You need one additional pro¬ 
gram for this, called the Broker. It can be gotten from the same Web site 
as you got sb747 from. 2 The Broker comes with its own documentation. 
Please make sure it works correctly before you try out sb747. 

2.3 Starting SquawkBox for PS1 

There are various ways of starting sb747. You can start it directly from 
the start/Run menu of Windows. This is convenient for a first try, but not 
suitable for permanent usage. 

You can also start sb747 from a dos window, which has the same draw¬ 
backs as from the start/Run menu. Flowever, you can write a batch file 
that includes commands to start both sb747 and friends plus psl together, 
or does even more things such as setting the volume of your sound card and 
download yoke commands. 

Lastly, you can start the program through an icon or shortcut that you 
make. This probably is the most handy way on Windows, especially if you 
also write a startup batch file which fires up psl and the associated helper 
programs on top. Putting the program somewhere in the Programs menu 
is a good alternative. 

All ways of starting are technically equivalent. You do not need to switch 
to the directory where the executable is located, the program will find out 
where it lives and from there it searches for the other required files. 

2 http://www.hoppie.nl/ 
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2.3.1 Recommended Start Order 

There is a preferred order to start all programs, although they do not de¬ 
pend on this order. Generally, it causes the least hiccups and error mes¬ 
sages when you start the Broker first, then SB747, then (if you want to) 
RogerWilco, then psl which will take you to full screen mode. You need 
to start RogerWilco before psl so that the first gets the sound card. With 
some sound cards, like the SoundBlaster Live! series, this is not any longer 
required, and you can let sb747 start RogerWilco when it is tuned for the 
first time. 

I n case one of the programs crashes, just restart it. All programs are 
designed to re-establish communication with each other as soon as they 
reappear on your system. I n case SB747 itself crashes, you need to make 
the server connection again manually. 
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C hapter 3 

Getting Started 


SquawkBoxfor psl has one main window with very few controls, si nee most 
work is being donefrom the psl flight deck (as it should). You have a File 
and a Help menu, a log area, a vhf entry line, a byte rate indicator, two 
activity indicators, and a three-way toggle switch. The menus are straight¬ 
forward, but most items in the File menu will only be meaningful when a 
server connection has been opened successfully. 

The log area shows a growing list (maximally 500 lines) of events that 
might be of interest to you. This list is a mixture of system messages and 



Figure3.1: The SquawkBoxfor psl Main Window 
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texts that are transmitted by the network controllers and pilots. Every¬ 
thing that is also sent tothe psl outside view window appears in boldface. 
Generally you only look here when you are puzzled by something, or to get 
confirmation that a certain action completed successfully. This area is not 
the main interface to the controller, because you will usepsl itself for that 
purpose. Should you find yourself in a position where you would want to 
interact with SB 747 directly though, then you can type your messages and 
commands in thevHF entry line and press Enter when done. The effect is 
the same as from the psl flight deck. 

N ext to the three-way toggle you find a byte rate display and two activity 
indicators. If you areonlineand receiving data, the byte rate display simply 
tells you how many bytes per second flow in. The indicator marked with an 
'S' is for Server, the 'P' is for psl. Each time a packet is received from the 
respective transmitter, the indicator turns green and increases (up to 99). 
If no packet has been received for a while, the indicator turns red. This does 
not necessarily mean that you havea problem, but it is worth investigating 
the cause. If the 'S' indicator turns red, there has been a suspiciously long 
period without any sign of life from the server. sb747 will detect this and 
also warn you by a vhf message. If nothing happens any more, cycle the 
connection off and on or switch to another server. I n general, try to keep 
both indicators green during a live session. 

The three-way toggle switch 'Online, Off, Robot’ lets you connect to the 
network, disconnect, or connect to the stand-alone (offline) atc robot. 

The program can generate a variety of other windows. These windows 
act as chi Id windows of the main window: when you minimize the main win¬ 
dow, the child windows will disappear as well. All windows can be moved 
and resized, and most of them will remember what you did to them. 

3.1 Setting Up SquawkBox 

The first thing you should do is to open the File/Setup menu and fill in 
the dialog box that pops up. It is divided into two parts, one for the server 
connection, one for SB 747 local settings. 

If you do not yet have a (virtual) pilot or controller license, apply for 
one at your network of choice. Before you select a server to connect to, you 
should check the same Web site to see which servers currently are online, 
and also to look for notams which might influence your flight. At the same 
time you can note the controllers which are active, which might influence 
your flight. 

You can easily switch servers in mid-flight by disconnecting, changing 
the server in the Setup box, and reconnecting. This will take you off a 
controller's screen for a few seconds only. Please fill in your real name at 
all times. You may add the nearest airport icao code to your name to give 
a hint about where you live. Pilot i d and password are handed out by your 
network and are strictly personal. 

I n the SquawkBox Configuration part of the dialog box, you must fill in 
thehostIP address where the Broker can be found. I n case the Broker runs 
on the same machine as SB 747, leave the default of 'localhost'. 
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Figure 3.2: The Setup Dialog Window 


The slider sets the minimum number of seconds in between messages 
in psl. When you do not have enough time to read the messages, increase 
this number. 

On slower systems, the 'High Priority’ setting might improve perfor¬ 
mance and decrease network lag. This switch will only take effect the next 
time you start SB 747. 

'Show Callsigns' can be handy in case you lose track of who is saying 
what to who. In reality, radio messages of course are not automatically 
tagged with the identity of the transmitter - that’s why there is such a 
strict protocol of callsign use! But virtual pilots and sometimes even con¬ 
trollers tend to get lazy about this, becausetheSquawkBoxfor msfs always 
displays the originating callsigns automatically. With this switch you can 
select whether or not you want the extra callsign display. 

Most times you would want automatic continuous weather updates, rea¬ 
son to check the box 'Weather Update'. This synchronises the weather in 
psl with the weather such as exists in the virtual world. This weather is 
more or less synchronised with the real weather in the real world. 1 If you 

x The real-world weather stations submit reports every hour. These reports are collected by 
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leave this switch off, SB 747 will not touch any weather setting, and another 
program such as SimWX 2 can take over. 

With 'Disconnect Message’ you can select whether or not you want a 
notification sent to you by acars if the network goes down. You will get a 
message in the outside view window in any case. 

The Traffic Passthrough’ setting should only be switched on if your sys¬ 
tem is powerful enough and if you want it. With this switch off, you do not 
get any pi I ots i n the 'P i I ots i n Range’ box and if you have any tc AS-capabl e 
program connected to the Broker, it won’t receive traffic information. The 
upsideisthat you will significantly reduce the cpu load that sb747 causes, 
especially when there is a lot of traffic out there. 

I n case you fly with your psl board clock set to real time, you will want 
to select 'clock callout,' so that your f/o warns you when the board clock 
deviates significantly from real (Zulu) time. 

'J oin acars network'enables the external acars functionality that you 
might want to use if you fly for a virtual airline. See Chapter 8 for an 
in-depth description of the external acars functionality. 

If you want to log everything that appears in the Log Window to a file, 
fill in the file name in the 'Log to File’ box. Leaving it empty means no 
logging takes place. 

Shouldyou desire to have RogerWi I co 3 integrated with sb747, you must 
fill in the full path to the roger. exe executable, too. I ncludethefile name 
itself in the path. I n case you use the separately available remote Roger- 
Wilcotuner, 4 so that you can run RogerWilcoon another machine as sb747, 
fill in remote. 

Your settings aresaved in thefileetc/sb747 . ini and will remain per¬ 
manent for as long as this file exists, or until you change them using the 
File/Setup dialog box again. There is quite a chance that you will not 
need to touch them any more after you have set them once. 

3.2 Filing a Flight Plan 

I n order to either connect to the network or to run the atc robot, you must 
file a flight plan. Open the Flight Plan dialog with File/Flight Plan. 
Most fields are to be treated as if you were filling in a real paper flight plan; 
they will appear exactly as you fill them in to the air traffic control I er(s), 
and they are not validated. Take care in selecting your call sign, because 
you will not be able to change it during your online session. All other fields 
can be changed whileyou areonline, so you can change your mind or divert 
simply by changing and then resubmitting your flight plan. Not filling in a 
field may lead to the network server rejecting your flight plan, so please fill 
them all in, even if it is with zeroes. 

some institutions such astheNOAA. The virtual air traffic networks download this information 
about every 90 minutes, so you might see a delay of a couple of hours compared to the real 
weather. 

2 http://www.weather.glideslope.de/ 

^ http://rogerwilco.gamespy.com 
4 http://www.hoppie.nl/rwd/ 
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Figure3.3: TheFlight Plan Dialog Window 


You must select a callsign that is unique at that moment for the whole 
network. An appropriate livery selection is up to you; select 'Boeing' for a 
no-frills standard Boeing 747-400 factory look. 

Origin, destination, and alternate airports (using four-letter icao codes) 
are straightforward, as are most other items. Your actual departure time 
obviously can be filled in only after you left the gate. Endurance is the 
estimated time you can stay airborne given your fuel load and burnoff rate. 
Use the Remarks line for generic remarks about your intentions; they will 
appear on the controller's flight strip next to your route. You can decide for 
yourself how detailed your route description will be. Note that there is a 
maximum of 300 characters in the route field. 

It is a good idea to just import your flight plan from the psl route file. 
You may have to dump the current psl fmc flight plan to disk first; either 
give that file a proper name or simply use'ACARS'sothat you can easily find 
it. psl route files can be found in theROUTES directory in the main psl di¬ 
rectory. I mporting the fmc flight plan has more advantages than just ease 
of use. Only when you import the flight plan, SB 747 will be able to pro¬ 
vide some route-dependant functions'. This influences mainly the external 
acars position reporting (which needs waypoint sequencing information) 
and the ability to gather forecast wind data for your flight route. These 
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functions won’t work without an imported flight plan. 

Submitting a flight plan also saves it in your preferences file, so the 
next time you start sb747, the flight plan will be there again. But it will 
not automatically be submitted, you will still need to do that manually by 
clicking the Submit button (after you reviewed the fields to see if they are 
still valid, of course). The Clear button erases all fields and gives you a 
blank sheet. 

After you complete your flight plan and have submitted it (you can al¬ 
ways resubmit it using the same button, replacing the old flight plan with 
the new one), you are ready to go! 


3.3 Testing your SB747 

First do a brief test to see whether SB 747 can contact your psl. Make sure 
the Broker is running and that sb747 has found it. This is announced by 
both the Broker and sb747. File a flight plan, no matter what, and click 
the three-way toggle to 'Robot'. SB 747 should announce that the robot is 
engaged. Now switch to or start psl, make sure the external data link is on 
(on the Preferences screen of psl), and wait. After a short wait, a message 
should appear in the outside view window and you should hear some radio 
static (unless RogerWilco has been started, too; this will most likely lock 
out your psl sounds). Now hit K' and type 'hello' in the vhf transmit line 
that appears in psl, followed by pressing 'Enter'. You should see your own 
message repeated in the outside view window. If this all works, you can be 
sure that sb747, the Broker, and psl are all set up correctly. Switch back 
to sb 747 (with Alt-Tab) and switch the robot off. 

3.4 Connecti ng to the Network 

Make sure that you have a working Internet connection, for example by 
visiting your network's home pagetocheck for special events and notams. 
Also make sure you have filed a valid flight plan. Then simply put the three- 
way switch on the sb747 main window to Online. The switch temporarily 
goes to standby mode, and after a few seconds it should settle in the Online 
position. 

If it falls back to Off, the reason for the failure to connect is shown in 
the log window. There are various reasons for a failed connection, ranging 
from plain network problems to a call sign that is already in use. Correct 
the problem, then try again. After connection, you should get a few 'login' 
messages from the network, which should be noted but usually do not tell 
you anything new. You are now connected to the server cluster, with your 
flight plan already filed and you call sign operational. You exist in the 
virtual world. 

The 'S’ activity indicator should turn green and increase steadily. You 
can get a rough indication of thetrafficin your area by watching this indica¬ 
tor; the quicker it increases, the more traffic. Should the indicator not run 
at all, there is most probably something wrong with either your connection 
or the server. Disconnect and reconnect again to see if that helps, or select 
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another server (in the Setup window). This does not destroy any of your 
settings or your flight plan. You can always just disconnect and reconnect 
later, but of course your plane will disappear in the virtual worldfor as long 
as you are offline. 

As soon as you are online, you can minimize the running SB747, since 
you will not need to use it from now on. Everything can be done from the 
psl flight deck. In psl, load in the situation you want, or set your position 
and other features yourself. 

Congratulations, you can start flying the virtual skies! 


3.5 Running the System 

If you tune the radio to the correct frequency (look in the Controllers in 
Range window for nearby controllers and their frequencies), you will see 
and hear atc messages coming by as usual, but thistimethey areliveand 
interactive. 

Go ahead! Tune into the clearance delivery or ground control frequency 
of your airport (or contact Tower, all depending on which controllers are 
available) and request clearance, using the terminology and phrasing you 
learned before. Soon you will be taxiing to the runway with quite some 
extra tasks to perform. Do not drive over those Cessnas 10 meters down 
below, please. 

If ever something breaks and your network connection gets severed, you 
might need to cycle SB 747 to Off, then back toOn//'netoget the ‘S’ indicator 
running again. This will not affect your appearance in the virtual world 
except for a short hiccup. Every time you expect that something is broken, 
especially if the 'S’ indicator stops running and turns red for more than 30 
seconds, just cycle the connection. I n case of doubt, ping a callsign that you 
know is present, such as 'server'who should always be there. 


3.6 Quitting a Session 

When you are done flying, first stop psl, then switch sb747 to Off. The log 
will confirm your disconnect time. Now you use the File/Exit menu to 
quit the program, followed by a disconnection of your I nternet line if you 
want to. The Broker should be killed last. 
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C hapter 4 

Communications 


This is what it is all about, of course. There can be no air traffic control 
without communications. In psl, you have three communication decvices 
at your disposal to contact atc: your set of vhf radios, your acars 'telex', 
and your transponder. 


4.1 VHF Radios 

Your main link to atc is, of course, your radio set. psl has one tuning 
panel on the flight deck (in reality there are three) which you use like you 
have been doing it all along. The frequency tuned here is the frequency 
you receive and transmit on. You won’t hear anything on other frequencies, 
except for the emergency frequency of 121.50 MHz which is automatically 
received all the time regardless of the tuned frequency. 

I n case you need to tune to a facility that uses a three-digit frequency, 
the two-digit psl tuner does not work. Usethe.freq 'dot command’ instead 
(Section 7.4). You can also use this command to review which frequency 
really is tuned, and to see which facility uses this frequency at the moment. 

The system takes into account that vhf radio transmissions have a lim¬ 
ited range and follow the I ine-of-sight rule. If you tune into New York while 
being over Europe, it will remain silent. While on the ground at Amster¬ 
dam Schiphol Airport, you will not hear London Heathrow Tower, but you 
might hear a pi aneenroute over London (if you tune the correct frequency). 

4.1.1 Transmitting 

You can transmit a message on the radio by pressing the'K' key. Make sure 
the fmc keyboard is off (press Shift once to switch it on or off). A brown 
entry box will appear below your pfd, with space for 25 characters to type. 
Use only lowercase letters and numbers, and as few special characters as 
possible, psl has a very limited character set and you can easily fool its 
'editor.' When your message is complete, press 'Enter' to transmit it on the 
tuned frequency. 

The entry box is quite short, and more elaborate messages do not fit in 
completely. By appending a dot'.' to your message, SB747 is instructed to 
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buffer it and not transmit immediately. Each line entered that ends in a 
dot is added to the buffer. Only when a line not ending in a dot is typed, all 
of the buffer plus this last line is sent out. PI ease make sure you give psl 
ti me to transmit each //'netoSB747 by waiting a second in between pressing 
‘E nter’ and ‘K ’ for the next I i ne. 

An important character, the underscore which is used in many atc 
callsigns, cannot be entered in psl. Instead you should use the dash 
which is automatically converted to an underscore by SB 747. Likewise, in- 
comi ng underscores are converted to dashes so that you do not get confused 
(well, not so quickly). 

I n case you want to repeat your last message, there is a .sa 'Say Again' 
command available. 

Lastly, there is an extensive character expansion mechanism in place 
that allows you to shorten messages that you use often to just a few 
keystrokes. More about this mechanism can be found in Section 7.5. 

4.1.2 Receiving 

IncomingvHF messages are displayed in the outside view window, in black 
on white, psl also tries to play a static radio noise sound with every incom¬ 
ing message. Should you not I ike this sound, it is in the static.wav file of 
the Broker's lib directory. 1 

I n order to prevent your outside view to be cl uttered up completely by a 
long message, sb747 breaks up long incoming messages into manageable 
parts. Each part counts as a separate message. 

The 'Setup' dialog lets you specify the minimum time between received 
messages. You should find a balance between having enough time to read 
it all and not running behind too much. Four to five seconds usually turns 
out quite well. The Broker contains another setting, the time a message 
stays on the screen. This is essentially the time the last message stays on 
the screen, since incoming messages from sb747 will always replace the 
current message immediately. 

When there is much chatter on the radio, and you have set the min¬ 
imum time between messages on the high side, you will notice that some 
messages are fol I owed by a trai I of dots. E ach dot represents a message that 
is waiting to be displayed. If this queue gets too long, you should decrease 
the minimum time between messages (in the Setup box), otherwise you will 
lag further and further behind atc. Messages which contain your call sign 
are automatically put at the head of the queue, to i mprove responsiveness. 

4.1.3 ATIS 

Receiving atis messages is also a function of the radio set. However, the 
network usually does not transmit atis on vhf directly, neither with the 
"facility atis" bound to a callsign nor with the "AutoATis" that is bound to a 
frequency. So in order to get ati s you must send a special command, .atis. 
The reception of the atis will be channeled to your vhf radio set, though, 
and you will get the message displayed in the outside view window. I n case 

1 Make sure that psl can get at this file, otherwise it obviously cannot play it. 
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you want to receive the atis associated with the facility you are already 
tuned into (either a facility atis or an AutoATis), you can just type .atis. 
sb 747 will try to find out the callsign by itself, or detect that you want a 
response from the at is server. In case you want to poll another facility, add 
its callsign to the .atis command. 

Not all stations provide atis all the time, and once in a whilethe mes¬ 
sage format is less than desirable for psl. In case of severe readability 
problems, temporarily switch back totheSB747 graphical user interfaceto 
peek at the log window. 

4.2 ACARS 

sb 747 has pretty good acars support. It does not perform all acars func¬ 
tions exactly like in reality, because psl does not allow overriding of the 
atis and weather functions. But you have full access to the tel ex function¬ 
ality, which can be used for about everything. 

Important: sb 747 has actually two acars systems. The one described 
here'lives'on the virtual air traffic network and uses the mcdu ofpsl. It 
is fully integrated in PS1, you do never need to leave the virtual flight deck 
to operate it. The other system, described in Chapter 8, uses a separate 
network that has nothing to do with either vatsim or ivao, and can only 
be accessed via the special mcdu thatSB747 provides. 

4.2.1 Telex 

Incoming private messages ('chat mode' and system-wide broadcasts) end 
up in your psl flight deck mcdu. They will sound the eicas chime and 
be announced on the scratch pad. You can use the standard acars telex 
page to review the message. If you have a message waiting to be read and 
another (new) message comes in, it will overwrite the waiting message. 
Each message is always preceded by the reception time in (PSl)Zulu. 

By means of the acars telex send feature, you can compose a message 
to any other station or plane on the virtual atc network. You must put the 
required callsign as the first word of the message, followed by the rest on 
as many lines as you need. After you press the send button of the fmc, the 
message will be sent directly to the facility. This can take a few seconds. If 
you try to send a message while the transmission of the previous message 
is still going on, the fmc will notify you with a 'buffer full' scratch pad 
message. 

As a shortcut to reply to incoming messages using the sender's callsign 
as the address, you can use the .r command. See Section 7.4 for more infor¬ 
mation about all the 'dot commands.' 

4.2.2 Weather Requests 

You cannot use the native psl 'Weather' functions with the flight deck 
mcdu, but a very close approximation is availablethrough the .metar com¬ 
mand. When you request a metar from any airport, the network server will 
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look up a recent m etar for that station and relay it to your acars as a pri¬ 
vate telex message. As with all 'dot commands', you can put the command 
either in the vhf transmission line or in an acars telex. Using acars to 
request weather information is of coursethe most realistic. 

4.3 Transponder 

During virtual flights, the transponder becomes an important instrument. 
If you switch it off (called squawk standby mode, code 0000), you will be 
invisibleto atc, so you can drive around thetarmac looking for a pi ace that 
suits you. Usually you are also invisible to other pilots when your squawk 
is on standby. As soon as you switch the transponder on (out of 0000), you 
will pop up on the radar screens and into other pilot's vision. 

It is a good idea to keep your transponder off until atc has assigned you 
a squawk. Note that in a real 744, the transponder is forced to standby 
mode whenever a wheel touches the ground, to protect sensitive equip¬ 
ment at the airport from being bombarded with high-energy transponder 
responses. It would be possible to model this in sb747 as well, but that 
would severely hamper the virtual ground controller in distinghuishing the 
planes on the ground. Most ground controllers do not have a visual 'tower' 
view, but use a ground radar screen only. 

Some controllers do not anticipate the squawk standby mode, and will 
complain that they do not have you on radar after your initial clearance 
request. I n such a case, please ask for a squawk code and put it into your 
transponder. I n general, when a controller does not see you on radar, cycle 
the transponder first. Strangely enough this is exactly what happens in real 
life all to often, too! 

You can send an i dent signal with the .ident command. Do this only 
when a controller specifically asks for 'ident.' It will make your radar blip 
stand out like a sore thumb on his screen. 
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Chapter 5 

Weather 


When you switch on sb747, it will essentially generate no weather at all: 
no winds, no clouds, no nothing. In order to get some weather up there, you 
must specifically ask for it. This can be done manually and automatically. 

5.1 Manual weather 

Setting weather manually is done by the .wxr command. This command 
accepts the i cao code of the airport you want to set the weather to. For 
example, if you are at New York J .F. Kennedy, you type .wxr kjfk. After a 
few seconds, sb 747 will have set the psl weather to that reported for kj fk. 
It might takeuptoa minute beforethe psl 'set weather'screen reflects the 
changes, but they are immediate, psl will take care that all changes are 
reasonably smoothed out - you won't find yourself suddenly in the middle 
of a roaring thunderstorm. 

This mechanism supposes that you regularly reset the weather to that 
observed at certain airports. While enroute, switch on the arpt feature 
of the navigation display and once in a while re-issue the .wxr command 
with an airport nearby. You need to get their metars anyway for your 
enroute deviation airport checks. At cruise altitude you will not at all ex- 
periencethe low-level weather at those airports, so you do not need to reset 
weather all thetime, but they will cause gradual upper wind changes, pres¬ 
sure changes, cloud cover changes, and temperature changes. 

Together with the ground level observations, sb747 also sets the winds 
aloft to the values that the network relays to it. Although these values 
are not the observations in reality (unlike the metar, the winds aloft are 
generated by a mostly random algorithm), they will be equal for all pilots 
in the vicinity. Only when they get really out of hand, you should use the 
.winds command to override the winds aloft. 

I n case you want to plan a long-haul flight, you can also use the .winds 
command to set the winds to the values you planned for. Since there are 
few airports in the oceans, it is probably best to use the last airport before 
the crossing as reference for the first half of the oceanic leg, and the first 
airport after the crossing for the second half. Or use the weather that is in 
effect at your current first choice deviation airport. 
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5.2 Automatic weather 

If you switch on the weather updates (in the Setup box), SB 747 will provide 
you automatically with thecorrect weather. The program determines where 
you are, and requests the correct weather for that area every five minutes. 
You can also force an immediate weather update to the nearest i cao station 
by the .wxr command (without an icao code). Sometimes the network 
cannot provide the weather for the requested station. I n that case, SB 747 
tries the next closest station, and continues until some weather is found. 

sb747 shifts to a reduced set of weather stations when below fl240 
to save cpu time. In cruise, all 6000+ icao stations are scanned for the 
nearest one. During departure or arrival, only the nearest 20 stations at 
the beginning of the flight or when crossing fl240 are used. 

Network winds aloft are not always as physically logical as you would 
want. They might even behave counter-intuitive, e.g., with their direction 
decreasing with altitude on the Northern hemisphere. This is due to the 
incomplete weather model of most networks, it is not an sb747 issue. In 
case the winds are really annoying, switch off the weather updates and set 
your own winds with the .winds command and your own weather with the 
.wxr command. 


5.3 Wind Aloft Forecasts 

On long-haul flights, it is mandatory to have proper wind aloft forecasts 
available. Unfortunately, theonlineATC networks do not provide real-world 
winds at altitude, so the normal skewed-T charts and other available re¬ 
sources are of no use for your flight planning. So sb 747 had to contain a 
smart look-ahead feature, so that you can actually get the winds out ahead 
before you get there. 

First, makesureyou imported a psl routefile in your flight plan, oth¬ 
erwise sb747 does not know where you want to fly. Then, go online, type 
.probe, and sit back. sb747 will fetch all the winds aloft on the waypoints 
of your flight plan for you, list them in the log window, and also dump them 
in the file etc\winds.txt. This feature is still under development, so it 
might produce slightly different information depending on what version of 
sb 747 you are using. 

During the probe sequence, your plane's radar echo will most likely 
blink a few times, so it is best (and most realistic) to probe the winds as 
part of your preflight and not while airborne. 

We are aware that the current mapping from network winds to psl 
winds is less than optimal. Any good solution to map from the four net¬ 
work wind layers to psl's continuous atmosphere model is welcome. 
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C hapter 6 

RogerWilco 


RogerWilco 1 is a free voice relay program that enables peopleto communi¬ 
cate with each other over the I nternet, while running their favourite pro¬ 
gram in the foreground. You need a good headset (headphones plus micro¬ 
phone) and a supported full-duplex sound card in order to work with Roger¬ 
Wilco. Although the network will always support text communications, if 
only as a backup, many controllers are now 'on voice' using RogerWilco and 
it is quickly turning into the preferred mode of communication. 

This manual does not detail the operation of RogerWilco, but some re¬ 
marks about running RogerWilco together with psl are in order. First and 
foremost, you must usually start RogerWilco before psl since they might 
conflict in their use of the sound card. Running one often means the other 
cannot get the sound card any more. If you start RogerWilco first, it will 
grasp the sound card, and psl will complain that it cannot find the sound 

1 http://rogerwilco.gamespy.com 



Figure 6.1: The RogerWilco Program 
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card. This is a pity, since you won’t have psl sounds any longer, but if 
you want to use RogerWilco it is the only choice. Fortunately the latest 
sound cards such as the SoundBlaster Live! series (including the signif¬ 
icantly cheaper Value Edition) support both psl continuous engine and 
event sounds and Windows (RogerWilco) sounds at the same time. 

Second, most networks urgently ask you to use RogerWilco in ptt mode, 
i.e., you need to push a button to talk. The voice activation mode, which 
switches on as soon as it detects sound, is too much of a hassle to be prac¬ 
tical. However, not all peoplecan get RogerWilco to 'see' a key pressed in 
psl. There are reports that the backslash key is suitable for use as a ptt 
key, but it is not guaranteed to work. I n case you can only get voice acti¬ 
vation mode to work, consider to put a physical switch in the microphone 
line to cut the audio feed manually. It works best to have the switch short 
the microphone signal, since this cuts out all hum as well. A regular light 
switch, meant for assembly in a lamp's mains wire, will do fine. 

6.1 Tuning RogerWilco 

The RogerWilco program must be 'tuned' to a facility in order to establish 
communications. A RogerWilco server (host) is a computer on the Inter¬ 
net, usually addressed by its ip number, such as 123.456.789.123. Several 
atc facilities tend to share the same RogerWilco host, so on the same host 
there are several channels. You must know both the host and the chan¬ 
nel of a facility if you want to contact to it. Most of the time, the correct 
host and channel are given in a station’s atis, such as in 'Voice available 
on 193.130.4.110/eham_v_app’. You can usually spot controllers who use 
voice communications because they have a _v_ in their callsign, but this is 
not a requirement. In th e Controllers in Range box, you can get an imme- 
diate overview of controllers with a RogerWilco voice connection. 

6.1.1 Manual tuning 

The most direct way to tune RogerWilco is by manually setting the host and 
then manually connect to (join) the channel: .rw h/193.130.4.110, then 
,rw j/eham-v-app. The chance is high that you do not need to reset the 
host often as many facilities use the same host. Note also that you can 
(must) use the dash instead of the underscore. 

When approaching an airport and directed by atc to switch to another 
frequency, and therefore RogerWilco channel, having to retune the radio, 
listen in to the new station's atis, then retune RogerWilco is completely 
impractical. SquawkBox 747 therefore contains an Autotuner that facili¬ 
tates RogerWilco channel switching. 

6.1.2 Autotuning 

Although not guaranteed fail-safe, the Autotuner will in most cases cor¬ 
rectly find the appropriate RogerWilco host and channel for you. 

Controllers are required to put their RogerWilco host and channel in 
their atis, so sb747 can look up this data for you. The program will ask 
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for the controller's atis as soon as the controller is recognized on the net¬ 
work, and re-fetch the atis every 30 minutes after that. Incoming atis 
messages are scanned for the RogerWilco host and channel, and if avail¬ 
able, this information is stored in sb747 memory. You can review this list 
in th e Controllers in Range box at all times. 

You activate the Autotuner with ,rw a/on. You only need todo this once, 
as this mode is retained in between SB747 sessions. In the rare occasion 
that you would want to deactivate the Autotuner, use .rw a/off. ,rw a lists 
the current Autotuner mode. 

Whilein Autotuner mode, sb747 will 'tune' RogerWilco immediately af¬ 
ter you change vhf frequency - you have instant contact with the new 
controller. sb747 will tell you whether a RogerWilco channel was avail¬ 
able, by flashing Connected to XXX on voice in the outside view window. 
Alternatively it tells you Connected toXXX on text. 

If you suspect a station to have changed RogerWilco host or channel, 
you can re-poll the station for the new information with the .rw p/callsign 
command. If you leavethe callsign out (.rw p), the currently tuned station 
is re-polled. This is very useful with many RogerWilco problems, as quite 
often a straightforward re-tune will solve them. In caseSB747 announces 
Connected on voice and you don’t get voice contact, try .rw p! 

6.1.3 Future Developments 

For true integration of RogerWilco, we need to wait until the networks com¬ 
plete a special RogerWilco mapping server, or integrates the RogerWilco 
channel in their server software. As soon as this facility becomes avail¬ 
able, each controller will automatically get a RogerWilco channel assigned 
to her/him, and this channel can be looked up in a standard way over the 
Internet. SB747will be adapted tothis automatic lookup procedureas soon 
as possibleafter the facility is made availableto the general public. 
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C hapter 7 


Extra Features 


Thecombopsl - sb747 - network has more features than 'just flying under 
atc.' This chapter summarizes some of the extra features. You can do 
without them, but it is nice to know they are there just in case. There is no 
specific ordering in the presentation yet. 


7.1 Lists of Pilots and Controllers in Range 

Through the File/Pilots in Range menu, you can get a live list of the 
planes that are within your range, i.e., within approximately 40 nm from 



Figure 7.1: Pilots in Range Dialog Window 


25 














Figure 7.2: Controllers in Range Dialog Window 


you. Network protocols do not deliver morethan the plane's call sign, lati¬ 
tude, longitude, altitude, attitude (which is ignored by sb747), speed, and 
plane model. If you want to know more about a specific plane, such as the 
name of its pilot, you have to look at your network's Web pages. 

On the last line of the list, separated from the others by an empty line, 
is the callsign and position of your own plane. This is mainly useful for 
checking whether you indeed are (in the virtual world) where you think 
you are. If this position is missing or consists of mainly zeroes, your psl 
connection has trouble. Check the Broker which data it shows. 

A short form of about the same data can be displayed on the flight deck 
with the .pilots command. Also, the tcas injector uses the planes on this 
list only. 

The Controllers in Range menu analogously presents a list of Air 
Traffic Controllers in range. However, the definition of 'in range' is more 
specific here: 


Ground Control 

5 nm 

Clearance Delivery 

5 nm 

Tower Control 

30 nm 

Departure Control 

100 nm 

Approach Control 

100 nm 

Center 

400 nm 

FSS 

1500 nm 


Generally you can communicate over the radio only with the controllers on 
this list, on the frequencies listed. The network Web page usually has a 
complete list of all controllers and pilots in the system. 

The list shows the controller's callsign, the facility type, current fre¬ 
quency, distancetoyou in nautical miles, and its RogerWilcohost and chan¬ 
nel if available. 

For your convenience, the facility that you are currently tuned to ap- 
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Figure 7.3: The Direct Communications Dialog Window 


pears in boldface. The facility that is geographically nearest (give or take 
a few miles) has a V'sign prefixed to the frequency. This is not often useful, 
except when you appear in controlled airspace with no contact yet. You can 
then use the nearest controller plus common sense to decide which facility 
to contact first. 

The list can be sorted on callsign or on distance to you. 

The .ate command provides you with a shortened list of controller infor¬ 
mation on the flight deck, including the "+" sign for the nearest facility. 

7.2 Direct Communications 

Using the interface straight through psl, you have only those options that 
a real airline pilot has to communicate: your transponder, acars, and a 
broadcasting transceiver. However, when you use the SB 747 program itself 
(and thus temporarily suspend psl unless you have two computers), you 
have the option of comfortable direct communication with any other party 
logged on to the network. This is often useful, for example when polling an 
atc what kind of services (s)he delivers (only approach, or also tower and 
ground, for example). 

If you want to initiate a direct communication session, you open the 
File/Direct Comm dialog box, and fill in the receiver's call sign. The only 
difference between normal radio communication and direct communication 
is that you do not tune a broadcasting frequency, but you 'dial a call sign,' 
and communication therefore is private. 

When somebody calls you directly while you are on the flight deck, you 
will get an acars telex message. 

In sb747, you can also press th ePing button, which will send a ping 
request to the given call sign. The .ping dot command (Section 7.4) has the 
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same effect from the flight deck. When you receive the pong echo back, it 
will be displayed in the message window, together with the time that has 
elapsed between your ping and the pong echo. More than a few seconds 
lag time indicates a bad (slow) line somewhere between you and the ping 
target. You could try to switch servers to see whether that improves lag 
time. 

As an extra feature, you can click on all lines in all windows (pilot list, 
atc list, direct communication) where call signs appear. The call sign will 
then be automatically transfered to the To:’ field. A doubleclick opens the 
Direct Communications dialog box with this callsign. 

7.3 Offline ATC: the Robot 

I n order to both save you money and provide you with atc cover on long- 
haul flights through uncontrolled airspace, sb747 has an atc robot that 
can take over from the human controller. Therobot isdesignedtosound like 
it is actually controlling a sector, but the underlying program is simplified. 
The communications between the controller and the other (virtual) planes 
in the sector are realistic, though. You will have enough chatter over the 
radio to keep you alert for messages meant for you. 

Currently, the robot is fairly simple, and it does not at all follow real- 
world sectors and restrictions. It even does not really listen to you, although 
it knows you are there and you should check on with Center after changing 
frequencies using the standard phraseology ("Center good afternoon, klm 
1534 with you level at flight level 370"). But si nee this part of the program 
is open to changes, it will grow in the future. It will become possible to add 
specific procedures for specific airports as well, which means that you then 
can use the robot not only for enroute (center) atc, but also for departure 
and approach control, and even tower and ground. 

For now, you must communicate with atc through your flight plan. If 
you want another cruise altitude, or descend tothe level wherethe psl atc 
can take over (fl240), just alter your cruise altitude in the (SquawkBox) 
flight plan. The robot will get you there, eventually. 


7.4 Dot Commands 

From the flight deck, you can not only transmit radio messages, but also 
have a limited control of SB747. You have this control through the use of 
dot commands, words that start with a dot'.' on a new line. Availabledot 
commands are (in alphabetical order): 

. E mpty command, causes the incoming vhf message window to be cleared. 
Useful in case some malfunction keeps your window cluttered with 
the last message received. 

.atc Produces a list of controllers in range and their frequencies. Can be 
filtered, for exampl e .atc eh produces only control I ers whose cal I si gns 
start with 'eh'. Useful for peeking which controller you are likely to 
be switched to, and to find out which controller to contact initially. 
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The display order is the same one as the currently selected sort order 
in the Controllers in Range box. 

.atis callsign Requests the atis of the given controller. Not all controllers 
have their atis installed. You should get a reply back in a few seconds, 
otherwise there is no atis. If you leave the callsign out, you will get 
the atis of the station your vhf radios aretuned into (if it has atis). 
Both facility atis and atis servers are supported; just tune in the 
right frequency. 

.eta hhmm Updates the estimated time of arrival at destination. Needs 
to be done once in a while to let the external acars module know at 
what time you think you will arrive. You can copy the fmc estimated 
time from the progress page. 

■fp Resubmits the flight plan, in case atc asks for this. Should never be 
required but the network once in a while drops flight plans. If you 
type something after the .fp, it will be filed as remarks to ATC. 

.freq Displays the currently tuned vhf frequency, including the callsign 
of the station currently operating on the frequency. If no callsign 
is displayed, the frequency is dead. When called with a parameter, 
tunes the vhf radio to the given frequency. This is useful for the 
new 8.33 kHz gridded ('channel') frequencies with three digits: .freq 
119 . 255 . 

.help Gives all available dot commands. 

.ident Causes your transponder to send an i dent signal for five seconds. 
Use this only when the air traffic controller asks for it. 

.metar icao-code I mitates an acars request for the m etar of the given 
ai rport. You wi 11 get back the most current true weather report of the 
airport as a real acars telex. 

.msg callsign your message here Sends a direct communication mes¬ 
sage to the callsign given. This can be either a pilot or a controller. 
If you use 'r' as the callsign, you will reply to the sender of the most 
currently received direct message. The same effect can be obtained 
with the .r command. 

.network on,off switches on/offline. A flight plan must have been filed for 
this function to work, which can be done with the .fp command. 

.pilots Like with the .atc command, you get back a list of callsigns and 
their current altitudes of the pilots (planes) in range. You can also 
filter this list with the first few characters of the cal I signs you want to 
see, e.g., .pilots klm. 

.ping callsign pings the given callsign. With no callsign given, pings the 
last station you received a private message from. 
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.probe fetches the current winds aloft of all waypoints in your filed 
flight plan, if this flight plan has been imported from a psl route 
file. The winds are shown in the log window and also saved in the 
etc\winds.txt file. They can be used for proper fuel planning and 
to feed the fmc more accurate wind information. 

.r message here Replies tothe most recently received private message. 

.robot on,off switches the atc robot on or off. 

.rw Displays the currently set RogerWilco host (IP address). This is not 
necessarily the host the RogerWilco is now tuned to. 

.rw a RogerWilco autotuning mode list. 

.rw a/on,off RogerWilco autotuner on/off. 

.rw h/hostIP Sets the RogerWilco host IP address for subsequent use by 
other .rw commands. 

.rw j/channel J oins the channel on RogerWilco, using the host that was 
previously set by .rw h/.... 

.rw I Leaves the currently joined RogerWilco channel. 

.rw p Re-polIs the currently tuned facility for RogerWilco info. 

.rw p/callsign Re-pol Is the given facility for RogerWilco info. 

.sa 'Say Again', repeats the last message you transmitted on vh f . 

.scan on,off switches the radio to scanner mode. In scanner mode, all 
received communications are shown in the log window. This might 
be handy in some debugging situations, but will quickly fill up the 
window if you are in a crowded environment. 

.winds Sets the winds aloft. A command without parameters deletes all 
winds. With a wind list given, psl will interpolate between the given 
winds to give the plane a wind changing with altitude and meeting 
the given wind points. A wind list looks like .winds 120/340/12/20 
240/010/25 370/030/40. The first number is the flight level, followed 
by the wind direction and speed, and optionally the gust speed. You 
can give any number of altitude winds. However, the psl flight deck 
entry line can likely not even accomodate one, so you are advised to 
use the sb 747 interface for this. 

.wxr icao-code Fetches the metar of the given airport (like the .metar 
command) and then sets the weather in psl to the received report. 
Also sets winds aloft to the network data, deleting the manually set 
winds with the .winds command. If you leave out the icao code, 
the command looks for the nearest i cao station and tries to fetch the 
weather for that station. If that fails, it tries for the next nearest, etc. 
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7.5 Expanding VHF Messages 

The etc/expand, txt file holds a list of phrase shortcuts or character ex¬ 
pansions that you can use to minimise typing to atc. The file contains 
entri es I i ke the fol I owi ng: 

c "$callsign" 
aa "$altitude feet" 

clr "$org ground, $callsign at gate $1 request clearance for $dest" 
ctr "$1 center, $callsign with you at FL$flightlevel" 
cm "climb to and maintain" 
d "direct" 

dm "descend to and maintain" 

dyr "do you read?" 

eil "established on ILS" 

elo "established on localizer" 

f "FL$flightlevel" 

fr "out of FL$flightlevel for $1" 

h "heading $heading" 

lvl "level at FL$flightlevel" 

n "negative" 

ph "present heading" 

r "roger, $callsign" 

gs "groundspeed $groundspeed knots" 

tl "turn left heading" 

tr "turn right heading" 

u "unable to comply" 

w "wilco, $callsign" 

y "affirmative" 

Each 'word' in the left column is replaced by the phrase in the right col¬ 
umn before the complete sentence is sent out. N ote that there are several 
variables included in the expanded phrases; they all start with a $ sign. 
These variables are filled in with actual values straight from psl at the 
moment of transmitting to atc. They can save you some more typing, but 
are sometimes not completely accurate. For example, the $aititude vari¬ 
able produces your true height above sea level, as required by the network; 
not the pressure altitude according to standard atmospherical pressure. 

There are also parameter variables such as $ l. These are used when you 
write commands, like clr, that need extra information in order to generate 
afull sentence. If you type clr/e 6, the expanded sentence will read ‘KJ FK 
ground, KLM123 at gate E6 request clearance for EFIAM' (or something 
similar). 

You are encouraged to change the expand.txt file as you wish; the 
authors do not claim that the provided set of shortcuts is of any real prac¬ 
tical value. For example, you may want to have each word that triggers an 
expansion start with a special character such as '=', to prevent accidental 
triggering of expansion rules. 

7.6 Ground Position Tracking Tricks 

Since psl is an i fr simulator, ground scenery is sparse at best. It is nearly 
impossible to follow taxiways, even if you have a detailed map at hand, 
because the outside visuals are not more than Spartan outlines of runways 
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plus some mysterious light poles. Nogates, buildings, taxiways, or holding 
I i nes. 

To solve this problem, a separate program that integrates into psl has 
been developed. You can download it from the I nternet. 1 This Taxi way’ pro¬ 
gram displays the appropriate ground map, straight from the controller's 
screen, on your lower eicas. An extension, called tf, is ableto display the 
actual network traffic as tcas symbols on top of this map, giving you a good 
overview of traffic in the neighborhood (up to about 640 nm distance). 

Alternatively you can use the position of ai rport gates 2 to create a 'way- 
point’ on the navigation display, so that you have some idea whereyou are. 


1 http://www.geocities.com/pslipc/twy.html 

2 http://infolab.kub.nl/people/hoppie/psl/gates 
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C hapter 8 

External Systems 


Next to the ‘internal’ chat functionality of the psl flight deck cdu, as dis¬ 
cussed in Section 4.2, SB747 offers a completely separate implementation 
that goes far further in capabilities. This system contains currently both 
an advanced acars system and a complete interface to the online atc sys¬ 
tems. In principle, you can use this interface instead of the native Windows 
sb 747 interface during most if not all of your flight. This provides a much 
better look and feel than the point-and-click interface which seldomly is 
encountered in a real airplane. 

8.1 The external mcdu 

You can get at the extended acars functionality only by installing the exter¬ 
nal mcdu, a separate program available from the same website as where 
you downloaded sb747 itself. This program displays a simplified mcdu on 
any computer you attach to your network. You will quickly feel at home 
with it. All required buttons and keys work, and you can use either the 
mouse or the standard psl mcdu keys to operate it. We had to program 
our own mcdu in order to implement more advanced acars features be¬ 
yond a simple one-page telex. 

If you have the external mcdu attached, pslwill stop using the internal 
psl cdu for all purposes except to tell you that a message appeared on the 
external mcdu. However, you are still free to use p si's cdu tosend telexes 
or other things. 

You are encouraged to find creative ways of encapsulating the external 
mcdu in your virtual cockpit; the program has plenty of features to blend 
in seamlessly in most hardware. You can even start more than one copy 
and have them all operate in a different mode, or in parallel in the same 
mode. Seethe mcdu manual for more information. 


8.2 Basic acars principles 

The sb 747 acars module is based on store-and-forward of discrete mes¬ 
sages. Imagine a network of ground stations (typically airline dispatch 
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offices), one central communication station, and many airborne stations. 
Each station has a unique call sign, and you can send messages to other 
stations by addressing them to the correct call sign. Each message travels 
to the central communication station, where it is stored. When the ad¬ 
dressee station checks in, the message gets delivered. 

You can have a peek at the central communication station on the Web. 1 
A separate application called acars747 is available to take on the role of 
ground station. Neither of these systems are exclusively for psl, so if you 
want to develop your own acars add-on, feel free to build further upon the 
common infrastructure. 

Essential in the system is that all stations drop by the communication 
station regularly to 'pick up mail.' If they don't, their mail is destroyed 24 
hours after being sent. So if you do not get any reply, your addressee might 
simply not be online (yet). An exception is made for pre-stored messages 
that are sent by a station to the communication station as some kind of 
'poste restante:' you can ask for these messages at any time, and they will 
get delivered to you instantly. Typical examples of these drop-off messages 
are load sheets, arrival information, and (live) weather bulletins. 

acars only works properly if you have a near-constant I nternet connec¬ 
tion during your flight. This is why the package is part of sb747, which 
already assumes such a connection. However, the acars system is com¬ 
pletely independent of the online network of your choice, with theexception 
of the weather (metar) retrieval functions. 

1 http://infolab.kub.nl/people/hoppie/psl/fl/acars/ 
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Figure 8.1: The External mcdu Window 
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8.3 acars menu structure 


The menu system of the acars module is not a perfect copy of a real airline 
acars system, because it is very hard to get proper information and every 
airline seems to have a completely different setup. If anything, it resembles 
theQantas model mixed up with Lufthansa. However, the functionality is 
largely the same over airlines. 

acars has three basic modes: preflight, inflight, and postflight. When 
you call up the acars menu, it will automatically drop into the most ap¬ 
propriate mode, but via the acars index choice you can always go to the 
main menu. This main menu also offers the Link Status choice, with which 
you can check whether your (I nternet) acars link is operational. If not, the 
system will tell you why not. 

8.3.1 Preflight 

Here you set up most of the required data elements. During flight, there is 
much less to do. If you file a SB 747 flight plan totheATC network, many of 
the details on the PreHight page will be filled in for you automatically. 

The System I nit prompt causes a cleanout of the acars system, which 
should be done before each flight (or, as a courtesy for the next pilot, after 
the flight). You need to push the lskI two times. 

Origin, Destination, and Alternate fields should contain the icao codes 
of your departure and arrival airports, pi us the most likely alternate. These 
fields will be used throughout the acars module for reports and requests. 
They are not linked to your fmc. 

In the right column, you can fill in your flight details, such as Flight 
number, Planned DepartureTime, and Estimated Ti me of Arrival. The lat¬ 
ter will be automatically recalculated when acars detects that your plane 
moves out of the gate, by adding current time and estimated flight time 
from the flight plan. You can manually reset it at anytime. Currently the 
eta is not yet taken over from the psl Progress fmc page. 

The flight number is used as your acars callsign. 
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Figure 8.3: The I nflight Page 


Very important is the Company field. Here you fill in the three-letter 
acronym of your company, such as klm , clx, or stv. If you fly for a virtual 
airline, your airline will tell you the company code to use. Most of the time, 
this is the address on the messages you send, but you can override it in 
some cases (these will be explained). 

I n principle, you will want to have all fields on the PreHight page filled 
in before departure. 

8.3.2 Inflight 

After you leave the gate, or by manual request, the /nflight page appears. 
This contains the items that you might needduringflight, uptothe moment 
you dock at the arrival gate and shut down. 

Since most acars systems work automatically, you do not need to do 
much here. If an external station requests a position report, it will be sent 
automatically, but you can forcefully send one vi a the Positi on Report choice. 
This opens a page where you cannot change anything, si nee it is all collected 
automatically. For the correct waypoint tracking, you will need to have 
imported the flight plan from a psl route file in sb747. Some items on 
this page are inoperative due to the limited access that SB 747 has to the 
psl fmc; this might improve in the future. A manual transmission of the 
position report is always addressed to your company ground station. 

The eta can be manually updated. Large deviations might trigger an 
automatic progress report to your home base. You should keep this figure 
more or less synchronised with the psl fmc Progress page, which in the 
future might be done automatically. 

I n case you decide to deviate to the prefiled alternate, you can simply 
press the lsk2l button. This will overwrite the destination with the alter¬ 
nate and ask for a new eta. You can also put a completely new icao code 
in this field, in case you want to deviate to a different field, or continue back 
to your original destination. Deviations are automatically reported to your 
home base. 
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Figure 8.4: The Event Times Page 

8.3.3 Postflight 

You end up here after docking at the arrival gate, or by manual selection. 
About the only option here is the Event Times page, which summarizes 
important operational data of your whole flight. This page contains the 
data that are included in the ' 0001 ' (out-off-on-in) progress reports which 
acars sends to your home base as soon as something important happens: 

Pushback Out time and eta are sent. 

Takeoff Out and off times, and eta are sent. 

Landing Out, off, and on times are sent. 

Docking Out, off, on, and in times are sent. Docking time reporting is de¬ 
layed until the plane has been stationary for more than two minutes. 

eta changed more than ten minutes and plane is in last 120 min¬ 
utes of flight Out and off times, plus revised eta are sent. 

20 minutes before eta Out, off, and eta are sent. 

You cannot change these data, as they are automatically acquired from sev¬ 
eral airplane systems and cheating is not approved by your company. 

Out Time you leave the gate; first motion of the plane after acars initial¬ 
ization. 

Off Time you get airborne. 

On Time you touch down. 

In Ti me you stop the pi ane for the I ast ti me after I andi ng (the system waits 
two minutes to be sure you really won't start moving again). 

acars calculates block time and flight time for you, so you can copy these 
figures into your flight log. As oooi progress reports are sent to your com¬ 
pany automatically, you do not need to manually send these administra¬ 
tively interesting times. 
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8.3.4 Received Messages 

The Received Messages selection brings you to the message log of the ex¬ 
ternal acars facility. Here you can access all messages that the system 
received from a ground station (uplink). There is no downlink log. 

The page opens up a list of all messages received, and you can select 
which one you want to view. A maximum of nine pages of five messages 
each can be retained by the system. If it fills up, the oldest messages go 
overboard. Each message can hold nine pages of five lines of 24 characters. 
M essage I i nes i n Iarge font are not yet reviewed by the crew ('new'). 

If you receive a new message while not viewing the Received Messages 
page, the mcdu scratch pad will pop up a message acars uplink to warn 
you (and the psl cdu will warn you, too). 

8.3.5 Requests 

Various requests can be made by the crew via acars. They are all collected 
on one single page, accessible from many places in the menu system. 

Route You can download a complete f m c route, so that you do not need to 
leave the cockpit at all for file handling, and also do not need to key 
in lengthy sequences of boring data. Your company must have made 
the route available to you, and tell you the company route code. If 
you have it, you may enter the code and press Send. If the route is 
available, it will be downloaded intoyour fmc and you may pick it up 
as follows: 

1. Goto the psl fmc rte page. 

2. Fill in acars in the coroutefield. 

3. Review, activate, and execute. 

Route repositories are company-specific. For more information about 
setting up a route repository, contact the author. A note: SB 747 saves 
the route in the same directory as where you imported your last psl 
flight plan from. You might need to import one flight plan once in 
order to set this directory (use the SB 747 File/Flight Plan menu, then 
click on I mport). 

Weather This only works when you fly online on oneoftheATC networks. 
You can select one of the three known icao codes (origin, destination, 
and alternate airports) or key in any other station you want to get 
weather from. When you press Send, the large font icao is sent out 
for weather information. The resulting coded metar is sent to your 
generic messages box, where you can keep it for later review. This 
also means that you may request more metars in a sequence; they 
will all be stored as they come in. 

Load sheet A very airline-specific item. If your airline uses this feature, 
you may pick up the final load manifest of your plane and drop it in 
your received messages buffer. 
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Figure8.5: TheATC Page 


Arrival info Another airline-specifc item, used for advance information 
about your destination: gate assignment, maintenance expected, crew 
rotation, connecting flights... 

Send Telex Used for free-form messages to home base or any other acars 
station you happen to know the callsign of. Remember that messages 
are stored in the central communication station until they are picked 
up, which might not be immediate if your addressee is not online yet. 

If, for one reason or another, the transmitting of a message fails, the Send 
button will changetoResendandyou maytry again. The/. inkStatus choice 
in the main acars menu offers more detail if something seems to go wrong. 

8.4 atc functions 

On theexternal mcdu, you will also find a livelist of atc stations 'in range' 
and a complete radio tuner, including RogerWilco (re)tuning. These pages 
are obviously not 'realistic' but can be very handy if you wonder what is 
going on online. They enable cockpit operation of otherwise very unnatural 
machinery. 

On theStat/ons/n Range page you seeall stations currently within radio 
range, ordered as you have ordered the same list in the Windows SB747 
interface. You can select one of the stations by the push of a button, which 
will instantly re-tune psl's radios. I n some pathological cases, this works 
better than actually using the real radio tuners; however, it is a hack. The 
station you are currently tuned to appears in large font, the rest in small 
font. 

The Radio Tuning page shows the currently tuned frequency, the sta¬ 
tion's callsign if there is a station operative on this frequency, and its Roger¬ 
Wilco details if available. You may re-poll the station for RogerWilco retails 
with lsk6r. Oncein a while this saves the day. Otherwise you may manu¬ 
ally override all items on this page except for the callsign. 
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Figure 8.6: The RadioTuning Page 



Figure 8.7: The GoF light gf 166 Versatile Radio Panel 


8.5 GoF light Hardware 

GoFlight Inc. 2 produces several hardware modules that have been inte¬ 
grated in sb747. You can tune the psl radios with it, and select transpon¬ 
der codes. For more information, visit my web site. 3 


-o-o-o-o- 


2 http://www.goflightinc.com/ 

3 http://www.hoppie,nl/gfsb747/ 
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